home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / library / wrip_23.lha / WRip.doc < prev    next >
Text File  |  1996-02-03  |  6KB  |  160 lines
  1.  
  2.     $VER: WRip V2.3 (03.02.95)
  3.           ====================
  4.  
  5. Introducing
  6.   WRip is a CLI util which scans input data for known formats and save them.
  7.   The input can be a NDOS Disk or a normal file.
  8.  
  9.   
  10. Requirements
  11.   MC68020 or better (special 68000 version is also supplied)
  12.   Kickstart 2.05 (V37) or better
  13.   xfdmaster.library for decrunching files (optional)
  14.   enough ram (disks will completely loaded to ram)
  15.   harddisk (strongly recommend)
  16.  
  17.  
  18. Disclaimer
  19.   No warranties of any kind are made to the functionality of this
  20.   program. You are using it ENTIRE at your own risk.
  21.  
  22.  
  23. Installation
  24.   just copy WRip anywhere you like (e.g. C:)
  25.  
  26.  
  27. Using
  28.   - enter the directory where the ripped formats should stored (cd ...)
  29.     start WRip with input as argument (eg "WRip DF0:" or "WRip DH2:xyz.ab")
  30.      now WRip reads the disk or loads the file
  31.      then it scans the data
  32.      if a format is recognized it will saved in the actual directory, the name
  33.      of the file is "format start_offset_in_source end_offset_in_source"
  34.   - its recommend to integrate WRip in your DirUtil (eg DOpus)
  35.     I use the following buttons : "WRip DF0:" "WRip RAD:" "WRip file" ...
  36.   - while WRip is loading or searching, you can break it with CTRL-C
  37.   - WRip is PURE and can made resident
  38.   - see CLI-Convention for further details
  39.  
  40.  
  41. WRip knows the follwing formats :
  42.   - Executable files ($000003F3), IFF files (FORM)
  43.   - various pack formats (ATM5, BOND, CrM2, CrM!, FIRE, GC!, ICE!, Ice!, IMP!,
  44.     LOB, LZWH, PP20, RNC0, RNC1, RNC2, S300, S401, S403, S404, SC, SF, SP,
  45.     SSUR, TPWM, XPKF) and some clones (ATN!, CHFI, Z&G!, TSM!)
  46. WRip gives you a message if one of the following crunch-id's were found :
  47.   - SFHD, SFCD, PX20, PACK, FVL, PIco, SA, S310, S400, "T.S "
  48.  
  49.  
  50. The CLI-Convention
  51.   - Template :
  52.     WRip INPUT/A,SD=SAVEDISK/S,SB=SAVEBOOTEXE/S,NE=NOEXE/S,DEEP/S,
  53.          AUTODEC/S,IGNOREERRORS/S,MU=MAXUNPACKED/K/N,MR=MAXRATIO/K/N,
  54.          TASKPRI/K/N
  55.  
  56.     INPUT/A        specify the data which will loaded
  57.             if it ends with ":" it is interpreted as a Device
  58.             otherwise as a file
  59.  
  60.     SD=SAVEDISK/S    if WRip has read a disk (device), the whole disk will
  61.             saved as "BIN__FullDisk" after scan
  62.  
  63.     SB=SAVEBOOTEXE/S if WRip has read a disk the Bootblock will saved as
  64.             a standard amiga executable namely "EXE__BootBlock"
  65.  
  66.     NE=NOEXE/S    if specified WRip will not scan for Executables
  67.             makes sense if you scan an Executable and need no
  68.             duplication of them (hoho!)
  69.  
  70.     DEEP/S        select the DEEP mode
  71.             in normal mode the area of a saved format will skipped
  72.             (ie not scanned), in DEEP mode these areas will also
  73.             scanned (ie not skipped)
  74.  
  75.     AUTODEC/S    if specified WRip will try to decrunch each detected
  76.             format, if decrunching is successful the file will
  77.             saved with extension ".dec" otherwise it will saved
  78.             crunched
  79.             (for this operation xfdmaster.library V34 is required)
  80.  
  81.     IGNERRS/S    if specified WRip will not immediately quit if an error
  82.             occurs while diskloading, but the unreadable area in
  83.             memory is filled with the pattern "WRIP" and WRip skips
  84.             to the next track
  85.             can used to scan a disk with read/write errors ...
  86.  
  87.     MU=MAXUNPACKED/K/N with this option you can set the internal variable
  88.             with same name (e.g. ... MU=150000 ...)
  89.             for any packed file found, WRip will compare the
  90.             unpacked size of the file against MAXUNPACKED, if
  91.             MAXUNPACKED is lower the file won't saved
  92.             it makes no sense to save a file that is unpacked
  93.             50 MB or so...
  94.             lower values speeds up the PP20-trace !
  95.             default: MAXUNPACKED=2000000
  96.  
  97.     MR=MAXRATIO/K/N    set internal variable MAXRATIO
  98.             this var is only used in PP20-trace at the moment
  99.             the var describes how large the unpacked file can be
  100.             dependent on the size packed, or with other words :
  101.             "packedsize * MAXRATIO > unpackedsize" must be true
  102.             otherwise the file won't saved
  103.             higher values than default will dramatically slow down
  104.             the trace-mode (see chapter PP20-trace)
  105.             default: MAXRATIO=4 (useful values 2...10)
  106.  
  107.     TASKPRI/K/N    with this option you can set the taskpriority of the
  108.             scanroutine, this is useful if you have a PP20-trace
  109.             which will take a long time, and want to do some
  110.             other things with your machine
  111.             default: TASKPRI=-3 (allowed values -10...10)
  112.  
  113.  
  114. PP20 trace-mode
  115.   - to rip PowerPacker files a special trace mode is used
  116.   - if a "PP20" ID will found WRip swiches to trace mode
  117.     the trace-mode will stopped if :
  118.       a valid PP20-file will recognized and saved
  119.       the next "PP20" ID will found
  120.       the end of file is reached
  121.       the user press CTRL-C (quits only the PP20-trace, must pressed again to
  122.       leave the program)
  123.   - important for the speed of the trace mode are the value of MAXUNPACKED
  124.     and MAXRATIO
  125.     e.g. if you want to rip a soundfile you can set MAXRATIO=2 because
  126.     PowerPacker is not able to compress real samples better than faktor 2
  127.     (gain « 50%)
  128.     see also CLI-Convention
  129.  
  130.  
  131. Other related Programms
  132.   - for decrunching the XFD-package (aminet:util/pack/xfd107.lha) is
  133.     recommend (aminet:util/virus/VZII_123.lha is newer?)
  134.   - a good program for ripping soundmodules is ExoticRipper
  135.     (aminet:mus/misc/ExoticRip229.lha)
  136.  
  137.  
  138. Bugs
  139.   - files saved can be corrupt because only ID and sizes are checked
  140.     (except CMP1,PP20,SSUR,TPWM they are always 100% clean)
  141.     the further process of corrupted files can crash other progs/your machine!
  142.   - not a bug :    never try to scan a FileSystemFormatted-Disk (resulting files
  143.         are waste, what else)
  144.  
  145.     
  146. Future plans
  147.   - nothing, I think this is the last release
  148.  
  149.  
  150. Contact me for bugs, improvements, comments, new formats ...
  151.  
  152. EMail:    jah@pub.th-zwickau.de
  153. WWW:    http://www.th-zwickau.de/~jah
  154. Mail:    Bert Jahn
  155.     Franz-Liszt-Straße 16
  156.     Rudolstadt
  157.     07407
  158.     Germany
  159.  
  160.